======================================================================
                 AIRNOTEZ42 HELPER v8.0.1
        Unified HUD, Vehicle, Postal Map, and Gameplay Helper
======================================================================

Created by: AirNotez42
Website: https://airnotez42.duckdns.org/AirNotez42/
Version: 8.0.1
Platform: Grand Theft Auto V PC / RAGE Plugin Hook / LSPDFR

----------------------------------------------------------------------
DESCRIPTION
----------------------------------------------------------------------

AirNotez42 Helper v8.0.1 is a unified GTA V and LSPDFR enhancement
package designed to bring important driving, navigation, vehicle, and
HUD information together in one configurable system.

The package includes the AirNotez42 Helper plugin, configurable settings,
postal and speed-limit databases, the AirNotez42 Blue-Line Postal Map,
and a minimap/HUD safe-zone package. The included v12 HUD fix preserves
native HUD scaling, keeps the minimap visible in the lower-left safe zone,
and helps prevent stretching on 21:9 and 32:9 ultrawide displays.

----------------------------------------------------------------------
MAIN FEATURES
----------------------------------------------------------------------

- Unified custom driving and vehicle HUD
- Dual-gauge vehicle display with speed and RPM information
- Odometer, trip, gear, fuel, and vehicle-status information
- Street, area, postal, and speed-limit information
- Three-digit postal support using the included Postals.json database
- Custom speed-limit data using the included SpeedLimits.csv file
- Keyboard and controller-friendly vehicle functions
- Vehicle key-fob lock and unlock support
- Turn signals, hazard lights, and seatbelt-related functions
- Custom Blue-Line pause-map and postal-map package
- Minimap and HUD safe-zone correction
- Native HUD scaling for standard, 21:9, and 32:9 displays
- Configurable options through AirNotez42Helper.ini
- Designed to work alongside LSPDFR and the AirNotez42 HUD/map system

Some features can be enabled, disabled, moved, or adjusted in the
AirNotez42Helper.ini configuration file.

----------------------------------------------------------------------
REQUIREMENTS
----------------------------------------------------------------------

- A legal PC copy of Grand Theft Auto V
- RAGE Plugin Hook compatible with your installed GTA V version
- LSPDFR, when using the police and on-duty features
- OpenIV for installing the included OIV map and HUD packages
- OpenIV ASI Loader, OpenIV.asi, and a working mods folder
- Microsoft .NET Framework 4.8

Always update GTA V dependencies before reporting a problem with the mod.

----------------------------------------------------------------------
IMPORTANT: BACK UP YOUR FILES
----------------------------------------------------------------------

Before installing the OIV packages, back up your GTA V mods folder or at
least the files that will be replaced. Custom maps, minimaps, frontend.xml
files, widescreen fixes, and other HUD mods may conflict with this package.

Do not install multiple AirNotez42 minimap/HUD fixes at the same time.

----------------------------------------------------------------------
PLUGIN INSTALLATION
----------------------------------------------------------------------

1. Close Grand Theft Auto V, RAGE Plugin Hook, and OpenIV.

2. Extract "AirNotez42Helper v8.0.1.rar" with WinRAR, 7-Zip, or another
   program that supports RAR archives.

3. Open the extracted "AirNotez42Helper v8.0.1" folder.

4. Copy the following items into your GTA V Plugins folder:

   - AirNotez42Helper.dll
   - AirNotez42Helper.ini
   - AirNotez42Helper folder

5. The completed installation should look like this:

   Grand Theft Auto V\Plugins\AirNotez42Helper.dll
   Grand Theft Auto V\Plugins\AirNotez42Helper.ini
   Grand Theft Auto V\Plugins\AirNotez42Helper\Postals.json
   Grand Theft Auto V\Plugins\AirNotez42Helper\SpeedLimits.csv
   Grand Theft Auto V\Plugins\AirNotez42Helper\Map\MapProfile.ini
   Grand Theft Auto V\Plugins\AirNotez42Helper\Map\PostalMap.bundle
   Grand Theft Auto V\Plugins\AirNotez42Helper\MapPackages\...

6. Do not rename the AirNotez42Helper folder or move its data files away
   from the plugin unless the configuration specifically tells you to.

----------------------------------------------------------------------
POSTAL MAP AND HUD INSTALLATION
----------------------------------------------------------------------

The two recommended v12 packages are located in the main extracted folder.
Install them in this order:

1. 1 - INSTALL - AirNotez42 Blue-Line Postal Map v12.0.oiv
2. 2 - INSTALL - AirNotez42 Minimap HUD Safe-Zone Fix v12.0.oiv

To install each OIV package:

1. Open OpenIV.
2. Select Grand Theft Auto V for Windows.
3. Turn on Edit Mode.
4. Select Tools, then Package Installer.
5. Browse to the OIV file.
6. Choose Install to the "mods" folder.
7. Allow the installation to finish before installing the next package.

Install the Blue-Line Postal Map first and the HUD Safe-Zone Fix second.
The HUD package changes frontend.xml and should be installed after the map
so its final minimap and safe-zone placement remains active.

----------------------------------------------------------------------
ULTRAWIDE AND LEGACY FALLBACK PACKAGES
----------------------------------------------------------------------

The recommended v12 HUD Safe-Zone Fix already preserves native global HUD
scaling and is designed to avoid 21:9 and 32:9 stretching.

The archive also contains older v11 map/HUD packages and a v11.2
"ULTRAWIDE FIX." These are compatibility fallback copies only. Do not
install a v11 HUD fix over v12 unless you are deliberately testing the
older layout, and never install more than one frontend/minimap fix at the
same time.

If you switch between HUD packages, restore your backed-up frontend.xml
or reinstall the desired package last.

----------------------------------------------------------------------
LOADING THE PLUGIN
----------------------------------------------------------------------

1. Start Grand Theft Auto V through RAGE Plugin Hook.
2. Configure RAGE Plugin Hook to load AirNotez42Helper.dll at startup,
   or open the RAGE console and load the plugin manually.
3. Go on duty through LSPDFR when using its police-related features.
4. Enter a vehicle and confirm that the HUD and vehicle systems appear.

Manual RAGE console command, when needed:

   LoadPlugin "AirNotez42Helper.dll"

----------------------------------------------------------------------
CONFIGURATION
----------------------------------------------------------------------

The primary configuration file is:

   Grand Theft Auto V\Plugins\AirNotez42Helper.ini

Close the game before editing this file. Use a text editor such as Notepad
or Notepad++. Keep a backup before making major changes.

The INI controls feature toggles, key/controller behavior, HUD placement,
vehicle functions, and other available settings. Invalid values can stop a
feature from loading correctly, so restore the original INI when testing a
configuration problem.

----------------------------------------------------------------------
COMPATIBILITY NOTES
----------------------------------------------------------------------

This package may conflict with mods that replace or reposition:

- frontend.xml
- The minimap, minimap mask, or minimap blur
- The pause-map texture or postal map
- Widescreen or ultrawide HUD scaling
- Street, zone, postal, speedometer, or vehicle HUD displays
- Vehicle lock, fuel, turn-signal, hazard, or seatbelt systems

Install only one mod that controls the same HUD or vehicle feature. When a
conflict occurs, the file installed last usually becomes the active file.

----------------------------------------------------------------------
TROUBLESHOOTING
----------------------------------------------------------------------

PLUGIN DOES NOT LOAD

- Confirm AirNotez42Helper.dll is directly inside GTA V\Plugins.
- Confirm AirNotez42Helper.ini and the AirNotez42Helper data folder are
  installed beside the DLL.
- Remove duplicate copies from the GTA V root, Plugins, or Plugins\LSPDFR.
- Confirm RAGE Plugin Hook supports your current GTA V build.
- Check RagePluginHook.log for the first AirNotez42Helper error.
- Restore the original INI and test again.

MINIMAP IS MISSING, OFF-SCREEN, OR STRETCHED

- Reinstall the v12 Blue-Line Postal Map first.
- Reinstall the v12 Minimap HUD Safe-Zone Fix second.
- Confirm both packages were installed to the OpenIV mods folder.
- Remove or disable other frontend.xml, minimap, or ultrawide HUD mods.
- Do not combine the v11.1, v11.2, and v12 HUD packages.
- Reset GTA V Safe Zone settings to a normal value and test again.

POSTALS OR SPEED LIMITS DO NOT DISPLAY

- Confirm Postals.json and SpeedLimits.csv remain inside the
  AirNotez42Helper data folder.
- Confirm the files were not renamed or opened and saved in an invalid
  format.
- Restore the original files from the archive.

HUD OVERLAPS ANOTHER MOD

- Disable the duplicate HUD feature in AirNotez42Helper.ini or in the
  other mod.
- Adjust the available HUD position or scale settings in the INI.
- Confirm that no older AirNotez42Helper INI is overriding v8.0.1.

GAME CRASHES AFTER INSTALLING THE OIV

- Restore your OpenIV backup or original mods-folder files.
- Test the plugin without the OIV packages.
- Reinstall the OIV packages one at a time to identify the conflict.
- Verify that OpenIV.asi and the mods folder are functioning correctly.

----------------------------------------------------------------------
UNINSTALLATION
----------------------------------------------------------------------

PLUGIN

Delete the following from GTA V\Plugins:

- AirNotez42Helper.dll
- AirNotez42Helper.ini
- AirNotez42Helper folder

MAP AND HUD FILES

Restore the files you backed up before installation, use your OpenIV backup,
or reinstall the original files into the mods folder. Removing only the DLL
does not restore map or frontend files installed by an OIV package.

----------------------------------------------------------------------
SUPPORT INFORMATION
----------------------------------------------------------------------

When requesting support, include:

- AirNotez42Helper version
- GTA V version
- RAGE Plugin Hook version
- LSPDFR version
- Screen resolution and aspect ratio
- A copy of RagePluginHook.log
- A description of other installed HUD, map, or vehicle-system mods
- The exact steps that cause the problem

Website:
https://airnotez42.duckdns.org/AirNotez42/

----------------------------------------------------------------------
CREDITS AND TERMS
----------------------------------------------------------------------

AirNotez42 Helper, its configuration, postal data integration, HUD system,
and custom package branding were created for the AirNotez42 Gaming
Marketplace.

Grand Theft Auto V, Rockstar Games, LSPDFR, RAGE Plugin Hook, and OpenIV
belong to their respective owners and developers. This package is not
endorsed by Rockstar Games or Take-Two Interactive.

Do not reupload, redistribute, sell, or claim this package as your own
without permission from AirNotez42.

======================================================================
                         END OF README
======================================================================
